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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.661: "Configuration Management (CM); Kernel CM; Requirements". 

32.662: "Configuration Management (CM); Kernel CM; Information Service (IS)". 

32.663: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP): 

Common Object Request Broker Architecture (CORBA) Solution Set (SS)". 

32.664: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP): Common 

Management Information Protocol (CMIP) Solution Set (SS)". 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are 
initiated either as single actions on single NEs of the 3G network, or as part of a complex procedure involving actions 
on many resources/objects in one or several NEs. 
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Scope 



The purpose of the present document is to define the mapping of the Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) to 
the protocol specific details necessary for implementation of this IRP in a CORBA/IDL environment. 

This Solution Set specification is related to 3GPP TS 32.662 (V5.2.x). 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.600: "Telecommunication management; Configuration Management (CM); Concept 

and high-level requirements". 

[4] 3GPP TS 32.662: "Telecommunication management; Configuration Management (CM); Kernel 

CM; Information Service (IS)". 

[5] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[6] Object Management Group 98 (November 1998): "Notification Service: Joint Revised Submission 

OMG TC Document telecom/98-11-01". 

[7] OMG CORBA Services (November 1996): "Common Object Services Specification" (clause 4 

contains the Event Service specification). 

[8] The Common Object Request Broker: Architecture and Specification (for specification of valid 

version, see [1]). 

[9] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[10] 3GPP TS 32. Ill -3: "Telecommunication management; Fault Management; Part 3: Alarm 

Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) 
Solution Set (SS)". 

[II] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 
management; Information Service (IS)". 
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Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.600 [3] and 3GPP TS 32.662 [4] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

IDL Interface Definition Language (OMG) 

IRP Integration Reference Point 

IS Information Service 

MO Managed Object 

MOC Managed Object Class 

NRM Network Resource Model 

OMG Object Management Group 

SS Solution Set 

VSE Vendor Specific Extensions 



IRP document version number string 



The IRP document version number (sometimes called "IRPVersion" or "SS version number") string is used to identify 
this specification. The string is derived using a rule described in 3GPP TS 32.312 [11]. The value of this string is 
defined by a constant in annex A. 

This string (or sequence of strings, if more than one version is supported) is returned in getKernelCmlRPVersion 
method and is carried in the first field of the notification header of all notifications related to this IRP. 



5 Architectural features 

The overall architectural feature of Kernel Configuration Management IRP is specified in 3GPP TS 32.662 [4]. 
This clause specifies features that are specific to the CORBA SS. 

5.1 Notifications 

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.303 [9]). 
The contents of the Kernel CM IRP notifications are defined in the present document. 

5.2 Filter language 

The filter language used in the SS is the Extended Trader Constraint Language (see OMG Notification Service [6]). 
IRP Agents may throw a FilterComplexityLimit exception when a given filter is too complex. However, for 3GPP 
Release 99 an "empty filter" shall be used i.e. a filter that satisfies all MOs of a scoped search (this does not affect the 
filter for notifications as defined in the Notification IRP - see 3GPP TS 32.303 [9]). 

5.3 Syntax for Distinguished Names and Versions 

The format of a Distinguished Name is defined in 3GPP TS 32.300 [5]. 
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The version of this IRP is represented as a string (see also clause 4). 



6 Mapping 

6.1 General mappings 

The IS parameter name managedObjectlnstance is mapped into DN. 

Attributes modelling associations as defined in the NRM (here also called "reference attributes") are in this SS mapped 
to attributes. The names of the reference attributes in the NRM are mapped to the corresponding attribute names in the 
MOC. When the cardinality for an association is 0..1 or 1..1 the datatype for the reference attribute is defined as an 
MOReference. The value of an MO reference contains the distinguished name of the associated MO. When the 
cardinality for an association allows more than one referred MO, the reference attribute will be of type 
MOReferenceSet, which contains a sequence of MO references. 

If a reference attribute is changed, an Attribute ValueChange notification is emitted. 

6.2 Operation and Notification mapping 

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) defines semantics of operation and notification visible across the 
Kernel Configuration Management IRP. The following table in this subclause indicates mapping of these operations and 
notifications to their equivalents defined in this SS. 

Table 6.2.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 
(3GPP TS 32.662 [4]) 


SS IVIethod 


Qualifier 


getNRMIRPVersion 


get NRM IRP version 


M 


notifyObjectCreation 

( to convey of a new Managed Object created) 


See Notification IRP: CORBA SS [9] 





notifyObjectDeletion 

( to convey of a Managed Object deleted) 


See Notification IRP: CORBA SS [9] 





notifyAttributeValueChange 

(to convey of a change of one or several attributes of a 

Managed Object) 


See Notification IRP: CORBA SS [9] 





getlRPVersion 


get l<ernel CM IRP versions 


M 


getOperationProfile 


get l<ernal CM IRP operation profile 





getNotificationProfile 


get l<ernel CM IRP notification profile 






6.3 Operation parameter mapping 



The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) defines semantics of parameters carried in operations across the 
Kernel Configuration Management IRP. The following tables in this subclause indicate the mapping of these 
parameters, as per operation, to their equivalents defined in this SS. 

Table 6.3.1 : Mapping from IS getNRMIRPVersion parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


versionNumberList 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


vSEVersionNumberList 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exceptions: 
GetNRMIRPVersion 


M 
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Table 6.3.2: Mapping from IS getKernelCmiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


versionNumberList 


return of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


exception GetKernelCmlRPVersionsException 


M 



Table 6.3.3: lUlapping from IS getOperationProf lie parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


IrpVersion 


ManagedGenericlRPConstDefs::VersionNumber kernel CM IRP version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type l\/lanagedGenericlRPGonstDefs::MethodUst 


M 


Status 


Exceptions: 

GetKernelCIVIIRPOperationProfileException, 
IVIanagedGenerJclRPSystem::OperationNotSupported, 
IVIanagedGenerJclRPSystem::lnvalidParameter 


M 



Table 6.3.4: Mapping from IS getNotif icationProf lie parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


IrpVersion 


IVIanagedGenericlRPGonstDefs::VersionNumber 
kernel CIVI IRP version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type ManagedGenericlRPConstDefs;:l\/lethodList 


M 


Status 


Exceptions: 

GetKernelCIVIIRPNotificationProfileException, 
l\/lanagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



6.4 Notification attribute mapping 



The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) identifies and defines the semantics of attributes for 

notif yOb jectCreation, notif yOb jectDeletion and notif yAttributeValueChange for use for its 
IRP. The following table in this subclause shows the mapping of the IS notifications to SS equivalents. 

Table 6.4.1 : Mapping from IS notifications to SS equivalents 



IS notifications in 3GPP TS 32.662 [4] 


SS notifications 


Qualifier 


NotifyObjectCreation 


push structured event 





NotifyObjectDeletion 


push structured event 





NotifyAttributeValue Change 


push structured event 






The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) also quahfies the attributes. The following tables in this subclause 
show the mapping of these IS attributes to SS equivalents. 

Table 6.4.2: Mapping from IS Notification Header attributes to SS equivalent 



IS Attribute of Notification 

Header in 3GPP TS 32.662 

[4] 


SS Attribute 


Qualifier 


managedObjectClass 


KernelCmNotifDefs::NotificationCommon::MANAGED OBJECTCLASS 


M 


managedObjectlnstance 


KernelCmNotifDefs::NotificationCommon::l\/IANAGED OBJECT INSTANCE 


M 


notificationid 


KernelCmNotifDefs::NotificationCommon::NOTIFICATION ID 





eventlime 


KernelCmNotifDefs::NotificationCommon::EVENT TIME 


M 


systemDN 


KernelCmNotifDefs::NotificationCommon::SYSTEM DN 





eventType 


header.fixed header.event type.type name 


M 
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Table 6.4.3: Mapping from IS notifyOb jectcreation attributes 
to SS equivalent OBJECT_CREATION 



IS Attribute of 

notifyOb jectcreation In 

3GPP TS 32.662 [4] 


SS Attribute 


Qualifier 


notificationHeader 


See table 6.4.2 


M 


correlatedNotifications 


KernelCmNotifDefs::MOCreation::CORRELATED NOTIFICATIONS 





additionalText 


KernelCmNotifDefs::MOCreation::ADDITIONAL TEXT 





sourcelndicator 


KemelCmNotifDefs::MOCreatlon::SOURCE INDICATOR 





attributeList 


KemelCMNotifDefs::MOCreation::MOAttributeSet (contained in 
remainder of body) 






Table 6.4.4: Mapping from IS notifyOb jectDeletion attributes 
to SS equivalent OBJECT_DELETION 



IS Attribute of 

notifyOb jectDeletion in 

3GPP TS 32.662 [4] 


SS Attribute 


Qualifier 


notificationHeader 


See table 6.4.2 


M 


correlatedNotifications 


KernelCmNotifDefs::MODeletion::CORRELATED NOTIFICATIONS 





additionalText 


KernelCmNotifDefs::MODeletion::ADDITIONAL TEXT 





sourcelndicator 


KernelCmNotifDefs::MODeletion::SOURCE INDICATOR 





attributeList 


KernelCMNotifDefs::IVIODeletion::MOAttributeSet (contained in 
remainder of body) 






Table 6.4.5: Mapping from IS notifyAttributeValueChange attributes 
to SS equivalent ATTRIBUTE_VALUE_CHANGE 



IS Attribute of 

notifyAttributeValueChange 
in 3GPP TS 32.662 [4] 


SS Attribute 


Qualifier 


notificationHeader 


See table 6.4.2 


M 


correlatedNotifications 


KernelCmNotifDefs::AttributeValueChange::CORRELATED NOTIFICATIONS 





additionalText 


KernelCmNotifDefs::AttributeValueChange::ADDITIONAL TEXT 


M 


sourcelndicator 


KernelCmNotifDefs::AttributeValueChange::SOURCE INDICATOR 





attributeValueChangeDefinition 


KernelCIVINotifDefs:: AttributeValueChange::MOAttributeSet (contained in 
remainder of body) 


M 
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7 



Use of OMG Structured Event 



In CORBA SS, OMG defined StructuredEvent (see OMG Notification Service [6]) is used to carry notifications. 
This clause identifies the OMG defined StructuredEvent attributes that carry the attributes of notifications defined 
in3GPPTS32.662[4]. 

The composition of OMG Structured Event, as defined in OMG Notification Service [6], is: 



Header 



Body 



Fixed Header 

doma i n_n ame 

type_name 

event_name 
Variable Header 

filter able__body_fields 
remainder_of_body 



The following table in this clause lists all OMG Structured Event attributes in its leftmost column. The second column 
identifies the SS attributes, if any, that shall be carried there. 

Attributes that are denoted as "optional" may be absent from the OMG Structured Event. As an example, if the optional 
additionalText attribute is not used for a particular notification, then the IRP Agent may exclude 
additionalText from the filterable body fields for that particular notification. Individual notifications from the 
same IRP Agent may include or exclude the same optional attribute. 

Table 7.1 : Use of OMG Structured Event 



SS Attribute 


OIVIG CORBA 

Structured 
Event attribute 


Comment 


There is no 
corresponding 
SS attribute 


domain_name 


It contains the supported SS document version (see clause 4). This version is defined 
by the string constant KernelCmlRPSystem::VERSION defined in this specification. 


Event Type 


type_name 


It is an attribute of notificationHeader. It shall indicate one of the following ITU-T 
defined semantics: Object Creation, Object Deletion and Attribute Value Change. It is 
a string. Its value is either defined by 
KernelCmNotifDefs::MOCreation::EVENT TYPE, 
KernelCmNotifDefs::MODeletion::EVENT TYPE or 
KernelCmNotifDefs::AttributeValueChange::EVENT TYPE 


- 


event name 


Shall be set to an empty string 


There is no 
corresponding 
SS attribute 


variable Header 




Managed 
Object Class, 
Managed 
Object 
Instance 


One NV pair of 

filterable_ 

bodyjields 


NV stands for name-value pair. Order arrangement of NV pairs is not significant. The 

name of NV-pair is always encoded in string. They are attributes of 

notificationHeader. 

Name of NV pair is a string, 

KernelCmNotifDefs::<interface>::MANAGED_OBJECTJNSTANCE where 

<interface> is either MOCreation, MODeletion or AttributeValueChange. 

Value of NV pair is a string. This string conveys the semantics of both the Managed 

Object Class and the Managed Object Instance. See corresponding table in 

Notification IRP: CORBA SS (3GPP TS 32.303 [9]). 


Notification Id 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of notificationHeader. 

Name of NV pair is a string, KernelCmNotifDefs::<interface>::NOTIFICATIONJD 
where <interface> is either MOCreation, MODeletion or AttributeValueChange. 
Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS 
(3GPP TS 32.303 [9]). 


Event Time 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of notificationHeader. 

Name of NV pair is a string, KernelCmNotifDefs::<interface>::EVENT_TIME where 

<interface> is either MOCreation, MODeletion or AttributeValueChange. 

Value of NV pair is a ManagedGenericlRPConstDefs::IRPTime defined in 

3GPP TS 32.303 [9]. 

See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [9]). 
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SS Attribute 


OIVIG CORBA 

Structured 
Event attribute 


Comment 


System DN 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of notificationHeader. 

Name of NV pair is a string, KernelCmNotifDefs::<interface>::SYSTEM_DN where 

<interface> is either IVIOCreation, IVIODeletion or AttributeValueChange. 

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS 

[9]. 


Correlated 
Notifications 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of the Object Creation, Object Deletion and Attribute Value Change 

notifications. 

Name of NV pair is a string, 

KernelCmNotifDefs::<interface>::CORRELATED_NOTIFICATIONS where 

<interface> is either IVIOCreation, IVIODeletion or AttributeValueChange. 

Value of NV pair is a KernelCmNotifDefs::CorrelatedNotificationSetType. 


Additional Text 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of the Object Creation, Object Deletion and Attribute Value Change 

notifications. 

Name of NV pair is a string, KernelCmNotifDefs::<interface>::ADDITIONAL_TEXT 

where <interface> is either IVIOCreation, MODeletion or AttributeValueChange. 

Value of NV pair is a string. 


Source 
Indicator 


One NV pair of 

filterable_ 

bodyjields 


It is an attribute of the Object Creation, Object Deletion and Attribute Value Change 
notifications. 

Name of NV pair is a string, KernelCmNotifDefs::<interface>::SOURCEJNDICATOR 
where <interface> is either IVIOCreation, MODeletion or AttributeValueChange. 
Value of NV pair is a string with values of either 
KernelCmNotifDefs::<interface>::RESOURCE OPERATION, 
KernelCmNotifDefs::<interface>::MANAGEMENT OPERATION or 
KernelCmNotifDefs::<interface>::UNKNOWN_OPERATION where <interface> is 
either IVIODeletion, MOCreation or AttributeValueChange. 


There is no 
corresponding 
SS attribute 




Is used to transport attribute information. For Object Creation notification, this is 
defined by KernelCmNotifDefs::IVIOCreation::lnitialAttributeValues. For Object 
Deletion notification, this is defined by 

KernelCmNotifDefs::IVIODeletion::AttributeValues. For Attribute Value Change 
notification, this is defined by 

KernelCmNotifDefs::AttributeValueChange::ModifiedAttributeSet. The name 
component of InitialAttributeValues, AttributeValues and ModifiedAttributeSet will be 
set to attribute names defined in KernelCmNRMDefs. 



£75/ 



3GPP TS 32.663 version 5.2.0 Release 5 1 2 ETSI TS 1 32 663 V5.2.0 (2004-06) 



8 Rules for NRM extensions 



This clause discusses how the models and IDL definitions provided in the present document can be extended for a 
particular implementation and still remain compliant with 3GPP SA5's specifications. 

8.1 Allowed extensions 

Vendor-specific MOCs may be supported. The vendor-specific MOCs may support new types of attributes. The 3GPP 
SA5-specified notifications may be issued referring to the vendor-specific MOCs and vendor-specific attributes. New 
MOCs shall be distinguishable from 3GPP SA5 MOCs by name. 3GPP SA5-specified and vendor-specific attributes 
may be used in vendor-specific MOCs. Vendor-specific attribute names shall be distinguishable from existing attribute 
names. 

NRM MOCs may be subclassed. Subclassed MOCs shall maintain the specified behaviour of the 3GPP SA5's superior 
classes. They may add vendor-specific behaviour with vendor-specific attributes. When subclassing, naming attributes 
cannot be changed. The subclassed MOC shall support all attributes of its superior class. Vendor-specific attributes 
cannot be added to 3GPP SA5 NRM MOCs without subclassing. 

When subclassing, the 3GPP SA5-specified containment rules and their specified cardinality shall still be followed. As 
an example, ManagementNode (or its subclasses) shall be contained under SubNetwork (or its subclasses). Also, in 
Rel-4, there may only be or 1 ManagementNode (or its subclasses) contained under SubNetwork (or its 
subclasses). 

Managed Object Instances may be instantiated as CORBA objects. This requires that the MOCs be represented in IDL. 
3GPP SA5's NRM MOCs are not currently specified in IDL, but may be specified in IDL for instantiation or 
subclassing purposes. However, management information models should not require that IRPManagers access the 
instantiated managed objects other than through supported methods in the present document. 

Extension rules related to notifications (Notification categories. Event Types, Extended Event Types etc.) are for further 
study. 

8.2 Extensions not allowed 

The IDL specifications in the present document cannot be edited or altered. Any additional IDL specifications shall be 
specified in separate IDL files. 

IDL interfaces (note: not MOCs) specified in the present document may not be subclassed or extended. New interfaces 
may be defined with vendor-specific methods. 
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Annex A (normative): 
CORBA IDL, Access Protocol 



#ifndef KernelCmIRPSystem_idl 
#define KernelCmIRPSystem_idl 

#include "ManagedGenericIRPConstDef s . idl" 
#include "ManagedGenericIRPSystem. idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5 . org" 

mo du le Kernel Cm I RP System 
( 

exception GetKernelCMIRPNotif icationProf lleException ( string reason; }; 
exception GetKernelCMIRPOperationProf lleException ( string reason; }; 
exception GetNRMIRPVersion ( string reason; }; 

/** 

* The KernelCmlrpOperations interface. 

* Supports a number of Resource Model versions. 
V 

interface KernelCmlrpOperations 
{ 

/ -k-k 

* Get the version (s) of the interface 

* @raises GetNRMIRPVersion when the system for some reason 

* can not return the supported versions. 

* @returns all supported versions. 

void get_NRM_IRP_version 

( 

out ManagedGenericIRPConstDef s : : VersionNumberSet versionNumberList , 
out ManagedGenericIRPConstDef s : : VersionNumberSet vSEVersionNumberLlst 

) 

raises (GetNRMIRPVersion) ; 



Return the list of all supported operations and their supported 
parameters for a specific KernelCM IRP version. 

ManagedGenericIRPConstDef s : :MethodList get_kernel_CM__IRP_operation_prof lie ( 

in ManagedGenericIRPConstDef s : : VersionNumber kernel_CM_IRP_version 
) 
raises (GetKernelCMIRPOperationProf lleException, 

ManagedGenericIRPSystem: : Ope rat lonNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for a specific KernelCM IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_kernel_CM_IRP_notif ication_prof lie 
( 

in ManagedGenericIRPConstDef s ; ; VersionNumber kernel_CM_IRP_version 
) 
raises (GetKernelCMIRPNotif icationProf lleException, 

ManagedGenericIRPSystem; : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif 
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Annex B (normative): 

CORBA IDL, Notification Definitions 



tifndef KernelCmNotifDef s_idl 
#define KernelCmNotifDef s_idl 

#include <TimeBase . idl> // CORBA Time Service 

#include <Notif icationlRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module KernelCmNotifDef s 



/** 

* Definition of ITU-T defined semantics. 

* These constants are used in the type__name 

* (header . f ixed_header . event_type . type_name) 

* field to denote the notification type 

* Note all values are unique among themselves. Other IRP documents 

* cannot use the same values. 
V 

const string ET_OBJECT_CREATION = "x6"; 

const string ET_OBJECT_DELETION = "x7"; 

const string ET_ATTRIBUTE_VALUE_CHANGE = "x8"; 



/** 

* Information about one attribute 

* - name defines the name of the attribute 

* - value defines the value of the attribute 

*/ 
struct MOAttribute 
{ 

string name; 
any value; 



typedef sequence <long> Notif IdSetType; 

/* 

This holds identifiers of notifications that are correlated. 

*/ 

struct CorrelatedNotif ication 

{ 

DN source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
Notif IdSetType notif_id__set ; // Set of related notification ids 



/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

V 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif IcationSetType; 



* A set of attribute names and values 
V 
typedef sequence<MOAttribute> MOAttributeSet; 
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/** 

* This interface defines fields that are common for all 

* notification types. 

* All constants in the scope of this interface will be 

* visible in the interfaces that inherits this. 

* For instance constant 

* NotificationCommon: :MANAGED_OBJECT_CLASS 

* can be addressed by MODeletion: :MANAGED_OBJECT_CLASS 
*/ 

/* 

This block identifies attributes which are included as part of the Kernel 

CM IRP . These attribute values should not clash with those defined for the 

attributes of notification header (see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string SOURCE_INDICATOR = "SOURCE"; 

const string ADDITIONAL_TEXT = "ADD_TEXT"; 

const string CORRELATED_NOTIFICATIONS = "CORREL_NOTIFS" ; 

); 

interface NotificationCommon 



* This constant defines a field in the filterable 

* information in a StructuredEvent . 

* This string is mapped to the name part of a 

* Property in the event and the value part will 

* carry the MO class name represented 

* as a string. 
V 

const string MANAGED_OBJECT_CLASS = 

NotificationlRPConstDefs: : AttributeNameValue : :MANAGED_OBJECT_CLASS; 



/** 

* This constant defines a field in the filterable 

* information in a StructuredEvent. 

* This string is mapped to the name part of a 

* Property in the event and the value part will 

* carry the MO distinguished name represented 

* as a string. 
V 

const string MANAGED_OBJECT_INSTANCE = 
NotificationlRPConstDefs: : AttributeNameValue : :MANAGED_OBJECT_INSTANCE; 



* This constant defines the name of the notification 

* ID property, which is transported in the 

* f ilterable_body_f ields 
*/ 

const string NOTIFICATION_ID = 

NotificationlRPConstDefs: : AttributeNameValue : :NOTIFICATION_ID; 



* This constant defines the name of the 

* event time property, which is transported in the 

* filterable_body_f ields . 

* The data type for the value of this property 

* is defined by datatype CommonlRPConstDef s : : IRPTime 
*/ 

const string EVENT_TIME = 

NotificationlRPConstDefs: : AttributeNameValue : : EVENT_TIME; 



* This constant defines the name of the 

* system name property, which is transported in the 

* filterable_body_f ields 
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*/ 

const string SYSTEM_DN = 

NotificationlRPConstDefs: : AttributeNameValue : :SYSTEM_DN; 



/** 

* This constant defines the name of the 

* source indicator property, which is transported in the 

* f ilterable_body_f ields 
V 

const string SOURCE_INDICATOR = 

KernelCmNotifDefs: : AttributeNameValue : : SOURCE_INDICATOR; 

/** 

* Valid values for the SOURCE_INDICATOR 

* property 
*/ 

const string RESOURCE_OPERATION = "RESOURCE OPERATION"; 
const string MANAGEMENT_OPERATION = "MANAGEMENT OPERATION"; 
const string UNKNOWN_OPERATION = "UNKNOWN"; 



* This constant defines the name of the 

* additional text property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is a string. 
*/ 

const string ADDITIONAL_TEXT = 

KernelCmNotifDefs: : AttributeNameValue : : ADDITIONAL_TEXT; 



* This constant defines the name of the 

* correlated notifications property, 

* which is transported in the 

* filterable_body_f ields 

* The value part of the property is 

* KernelCmNotifDefs: : CorrelatedNotif icationSetType 
V 

const string CORRELATED_NOTIFICATIONS = 

KernelCmNotifDefs: : AttributeNameValue : : CORRELATED_NOTIFICATIONS; 



}; 



I -k -k 

* Constant definitions for the MO deleted notification 

*/ 
interface MODeletion : Notif icationCommon 
{ 

const string EVENT_TYPE = ET_OBJECT_DELETION; 



I -k-k 

* This information mapped into the remainder_of_body 

* in the StructuredEvent 
*/ 

typedef MOAttributeSet AttributeValues; 



/** 

* Constant definitions for the MO created notification 

*/ 
interface MOCreation : Notif icationCommon 
{ 

const string EVENT_TYPE = ET_OBJECT_CREATION; 
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* This information mapped into the remainder_of_body 

* in the StructuredEvent 
V 

typedef MOAttributeSet InitialAttributeValues; 

}; 



* Constant definitions for the Attribute Value Change 

* notification 
V 

interface AttributeValueChange : Notif icationCommon 
{ 

const string EVENT_TYPE = ET_ATTRIBUTE_VALUE_CHANGE; 

/** 

* Information about modidified attributes for 

* one MO instance. 

* - name defines the name of the attribute 

* - newValue defines the new value of the attribute 

* - oldValue defines the previous value of the attribute 

* The value is optional, which means that it may contain 

* an empty any (null inserted in the any) . 

*/ 

struct Modif iedAttribute 
{ 

string name; 

any newValue; 

any oldValue; 



/** 

* This information mapped into the remainder_of_body 

* in the StructuredEvent. 
*/ 

typedef sequence<Modif iedAttribute> Modif iedAttributeSet; 



#endif 
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Annex C (informative): 
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